Loading TOC...

MarkLogic 9 Product Documentation
GET /manage/v2/forests/{id|name}?view=status

Summary

Retrieve status information about the named forest.

URL Parameters
format The format of the returned data. Can be either html, json, or xml (default). This value overrides the Accept header if both are present.
Request Headers
Accept The expected MIME type of the response. If the format parameter is present, it takes precedence over the Accept header.
Response Headers
Content-type The MIME type of the data in the response body. Depending upon the value of the format parameter or Accept header, one of application/xml, application/json, or text/html.

Response

Upon success, MarkLogic Server returns status code 200 (OK), and the response body contains the requested data.

Required Privileges

This operation requires the manage-user role, or the following privilege:

http://marklogic.com/xdmp/privileges/manage

Usage Notes

The structure of the output returned from this REST API is as follows:

id

A forest unique ID (64-bit value).

name

The forest name.

meta

Properties of the view rather than the resource.

This is a complex structure with the following children:

uri

The path to the view.

current-time

The timestamp for when the view was generated.

elapsed-time

The time required to construct the view. The elapsed time indicates the relative cost of generating the view. Consider the cost when determining how frequently to request a view.

start-min

The timestamp for filtering out more recent requests or transactions.

view-error

An error limiting the data in the view.

This is a complex structure with the following children:

error-type

The kind of error.

error-name

The name of the error.

error-code

The error identifier.

error-message

The error text.

relations

Relationships to resources.

This is a complex structure with the following children:

relation-group

Related resources with the same type.

This is a complex structure with the following children:

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

roleref

A role that distinguishes the resource.

relation-count

The number of related resources.

relation

A specific related resource.

This is a complex structure with the following children:

qualifiers

A list of associated resources that distinguish the resource.

This is a complex structure with the following children:

qualifier

Another resource that qualifies the resource.

This is a complex structure with the following children:

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

roleref

A role that distinguishes the resource.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

status-properties

The operating characteristics of the forest.

This is a complex structure with the following children:

state

The state of the forest.

state-detail

Additional details on why a forest is in a particular state.

enabled

Forest enabled status.

availability

Availability of the forest data.

encryption

Forest encryption setting

updates-allowed

The kinds of updates that should be allowed for this forest.

rebalancer-enable

Enable automatic rebalancing after configuration changes.

lower-bound

The lower bound of the range on the forest.

upper-bound

The upper bound of the range on the forest.

master-forest

A forest unique ID (64-bit value).

replica-forests

The replica forests.

This is a complex structure with the following children:

replica-forest

A forest unique ID (64-bit value).

current-master-forest

A forest unique ID (64-bit value).

current-master-precise-time

current-master-fsn

current-foreign-master-cluster

A cluster ID.

current-foreign-master-database

The database ID.

current-foreign-master-forest

A forest unique ID (64-bit value).

current-foreign-master-precise-time

current-foreign-master-fsn

error

The error in processing forest status.

rebalancer-error

The error in rebalancing.

last-state-change

The last time the forest state changed.

nonblocking-timestamp

The most current timestamp for which a query will execute without waiting for transactions to settle.

max-query-timestamp

The largest timestamp a query has run at.

timestamp-table

Table of blocked timestamps.

This is a complex structure with the following children:

timestamp-entry

Blocked timestamp.

This is a complex structure with the following children:

timestamp

Blocked timestamp.

count

The reference count.

numa-node

A NUMA node number.

data-dir

The data directory.

large-data-dir

The large data directory.

fast-data-dir

The fast data directory.

journals-size

The amount of space the journals take up on disk.

large-data-size

The amount of space large objects take up on disk.

orphaned-binaries

The count of orphaned large binaries.

stands

The stands in the forest.

This is a complex structure with the following children:

stand

The stand of a forest.

This is a complex structure with the following children:

stand-id

The unique key of a stand.

path

The path of the stand.

stand-kind

The kind of stand.

is-fast

Is the stand in the fast data directory ?

label-version

The version number of the label file.

disk-size

The amount of space the stand takes on disk.

encrypted-disk-size

The amount of space the stand has encrypted on disk.

memory-size

The amount of space the stand takes in memory.

list-cache-hits

The number of hits on the list cache.

list-cache-misses

The number of misses on the list cache.

list-cache-hit-rate

The average number of hits on the list cache.

list-cache-miss-rate

The average number of misses on the list cache.

compressed-tree-cache-hits

The number of hits on the compressed cache.

compressed-tree-cache-misses

The number of misses on the compressed cache.

compressed-tree-cache-hit-rate

The average number of hits on the compressed cache.

compressed-tree-cache-miss-rate

The average number of misses on the compressed cache.

triple-cache-hits

The number of hits on the list cache.

triple-cache-misses

The number of misses on the list cache.

triple-cache-hit-rate

The average number of hits on the list cache.

triple-cache-miss-rate

The average number of misses on the list cache.

triple-value-cache-hits

The number of hits on the list cache.

triple-value-cache-misses

The number of misses on the list cache.

triple-value-cache-hit-rate

The average number of hits on the list cache.

triple-value-cache-miss-rate

The average number of misses on the list cache.

forest-reserve

The amount of space needed for merging.

merges

The merges in progress on the forest.

This is a complex structure with the following children:

merge

The merge of two stands in a forest.

This is a complex structure with the following children:

merge-id

A unique key for a merge.

canceled

Is a merge canceled or not.

input-stands

The input stands of a merge.

This is a complex structure with the following children:

stand-id

The unique key of a stand.

path

The path of the stand.

output-stand

The ID of a stand resulting from a merge.

start-time

The time a merge started.

final-size

The estimated final size of a stand.

current-size

The current size of a merging stand.

merge-rate

The rate of a merge (MB/sec).

rebalancing

Is this forest rebalancing.

reindexing

Is this forest reindexing.

device-space

The amount of space left on forest device.

large-device-space

The amount of space left on large forest device.

fast-device-space

The amount of space left on fast forest device.

last-backup

The last time the forest was backed up.

last-incr-backup

The last time the forest was incremental backed up.

backups

The backups in progress on the forest.

This is a complex structure with the following children:

backup

The backup of a forest.

This is a complex structure with the following children:

path

The path of the stand.

start-time

The time a merge started.

final-size

The estimated final size of a stand.

current-size

The current size of a merging stand.

incremental-backup

Is incremental backup enabled for the backup?

journal-archiving

Is journal archiving enabled for the backup?

journal-archive-path

Path to the associated journal archive location.

journal-archive-lag-limit

Number of seconds the archived journal can lag the active journal.

last-restore

The last time the forest was restored.

restore

The restore of a forest.

This is a complex structure with the following children:

path

The path of the stand.

start-time

The time a merge started.

final-size

The estimated final size of a stand.

current-size

The current size of a merging stand.

restore-state

The state of the forest restore.

restore-to-time

The date and time this backup was created.

incremental-backup

Is incremental backup enabled for the backup?

journal-archiving

Is journal archiving enabled for the backup?

journal-archive-path

Path to the associated journal archive location.

safe-restore-to-time

The safest timestamp closest to the restore-to-time at which the forest is in a consistent state.

transaction-coordinators

The set of transactions that this forest is coordinating.

This is a complex structure with the following children:

transaction-coordinator

A transaction that this forest is coordinating.

This is a complex structure with the following children:

transaction-id

The unique key of the transaction.

decision-state

The state of the transaction.

xid

The Xid.

This is a complex structure with the following children:

global-transaction-id

The global transaction ID of a Xid.

branch-qualifier

The branch qualifier of a Xid.

participants

The set of participating transactions.

This is a complex structure with the following children:

participant

A participating transaction.

This is a complex structure with the following children:

participant-id

The forest ID of a participant of a transaction.

participant-status

The state of the participating transaction.

size

The number of bytes taken up in the journal by this in-process transaction information.

transaction-participants

The set of transactions that this forest is participating in.

This is a complex structure with the following children:

transaction-participant

A transaction that this forest is participating in.

This is a complex structure with the following children:

transaction-id

The unique key of the transaction.

coordinator-id

The forest ID of the coordinator of a transaction.

min-commit-timestamp

The minimum commit timestamp for the transaction.

size

The number of bytes taken up in the journal by this in-process transaction information.

transaction-journal-size

The number of bytes taken up in the journal by the in-process transactions.

transaction-journal-limit

The maximum number of bytes that can be taken up in the journal by the in-process transactions.

query-read-bytes

The number of bytes read off disk.

query-read-time

The time (as xs:dayTimeDuration) to read query data from disk.

query-read-rate

The moving average of throughput reading query data from disk, in megabytes per second.

query-read-load

Disk reading time threads spent for a query in proportion to the elapsed time. This is a moving average summed for all of the contributing threads.

journal-write-bytes

The number of bytes written to the journal on disk.

journal-write-time

The time (as xs:dayTimeDuration) to write data to the journal.

journal-write-rate

The moving average of writing data to the journal, in megabytes per second.

journal-write-load

Journal writing time threads spent in proportion to the elapsed time. This is summed for all of the threads writing on the host.

save-write-bytes

The number of bytes written when saving in-memory stands.

save-write-time

The time (as xs:dayTimeDuration) spent saving in-memory stands.

save-write-rate

The moving average of writing data to in-memory stands, in megabytes per second.

save-write-load

The moving average of time threads spent writing to in-memory stands, in proportion to the elapsed time. This is summed for all of the threads writing on the host.

merge-read-bytes

The number of bytes read during merges.

merge-read-time

The time (as xs:dayTimeDuration) to read data for merges.

merge-read-rate

The moving average throughput of reading merge data from disk, in megabytes per second.

merge-read-load

Disk read time threads spent during merge, in proportion to the elapsed time. This is summed for all of the contributing threads.

merge-write-bytes

The number of bytes written to disk for merges.

merge-write-time

The time (as xs:dayTimeDuration) to write data for merges.

merge-write-rate

The moving average throughput of writing data for merges, in megabytes per second.

merge-write-load

Disk writing time threads spent for merges, in proportion to the elapsed time. This is summed for all of the threads writing on the host.

backup-read-bytes

The number of bytes read from disk for backups.

backup-read-time

Thee time (as xs:dayTimeDuration) to read data for backups.

backup-read-rate

The moving average throughput of reading backup data from disk, in megabytes per second.

backup-read-load

Disk read time threads spent for backup, in proportion to the elapsed time. This is summed for all of the contributing threads.

backup-write-bytes

The number of bytes written to disk for backups.

backup-write-time

The time (as xs:dayTimeDuration) to write data to backups.

backup-write-rate

The moving average throughput of writing data for backups, in megabytes per second.

backup-write-load

Disk writing time threads spent for backups, in proportion to the elapsed time. This is summed for all of the threads writing on the host.

restore-read-bytes

The number of bytes read from disk for restores.

restore-read-time

The time (as xs:dayTimeDuration) to read data for restores.

restore-read-rate

The moving average throughput of reading restore data from disk, in megabytes per second.

restore-read-load

Disk read time threads spent for restores, in proportion to the elapsed time. This is summed for all of the contributing threads.

restore-write-bytes

The number of bytes written to disk for restores.

restore-write-time

The time (as xs:dayTimeDuration) to write data for restores.

restore-write-rate

The moving average throughput of writing data for restores, in megabytes per second.

restore-write-load

Disk write time threads spent for restores, in proportion to the elasped time. This is summed for all of the threads writing on the host.

large-read-bytes

The number of bytes read from large documents.

large-read-time

The time (as xs:dayTimeDuration) to read data from large documents.

large-read-rate

The moving average throughput of reading large documents from disk, in megabytes per second.

large-read-load

Disk read time threads spent on large documents, in proportion to the elapsed time.

large-write-bytes

The number of bytes written to disk for large documents.

large-write-time

The time (as xs:dayTimeDuration) to write data for large documents.

large-write-rate

The moving average throughput of writing data for large documents, in megabytes per second.

large-write-load

Disk write time threads spent for large documents, in proportion to the elapsed time.

database-replication-receive-bytes

The number of bytes received for database replication.

database-replication-receive-time

The time (as xs:dayTimeDuration) to receive data for database replication.

database-replication-receive-rate

The moving average throughput of receiving data for database replication, in megabytes per second.

database-replication-receive-load

Time threads spent receiving data for database replication, in proportion to the elapsed time.

database-replication-send-bytes

The number of bytes sent for database replication.

database-replication-send-time

The time (as xs:dayTimeDuration) to send data for database replication.

database-replication-send-rate

The moving average throughput of sending data for database replication, in megabytes per second.

database-replication-send-load

Time threads spent sending data for database replication, in proportion to the elapsed time.

read-lock-count

The total number of read locks, summed across all forests on the host.

read-lock-wait-time

The total time spent waiting for read locks, summed across all forests on the host.

read-lock-hold-time

The total time spent holding read locks, summed across all forests on the host.

read-lock-rate

The rate of read lock acquistions, summed across all forests on the host.

read-lock-wait-load

Time threads spent waiting to acquire read locks in proportion to the elasped time, summed across all forests on the host.

read-lock-hold-load

Time threads spent holding read locks in proportion to the elapsed time, summed across all forests on the host.

write-lock-count

The total number of write lock acquistions, summed across all forests on the host.

write-lock-wait-time

The total time spent waiting for write locks, summed across all forests on the host.

write-lock-hold-time

The total time spent holding write locks, summed across all forests on the host.

write-lock-rate

The rate of write lock acquistions, summed across all forests on the host.

write-lock-wait-load

Time threads spent waiting to acquire write locks in proportion to the elapsed time, summed across all forests on the host.

write-lock-hold-load

Time threads spent holding write locks in proportion to the elapsed time, summed across all forests on the host.

deadlock-count

The number of deadlocks, summed across all forests on the host.

deadlock-wait-time

The total time spent waiting for locks that eventually deadlocked, summed across all forests on the host.

deadlock-rate

The rate of deadlock occurrances, summed across all forests on the host.

deadlock-wait-load

Time threads spent waiting for locks that eventually result in deadlocks in proportion to the elasped time, summed across all forests on the host.

large-binary-cache-hits

The number of hits on the large binary cache.

large-binary-cache-misses

The number of misses on the large binary cache.

large-binary-cache-hit-rate

The average number of hits on the large binary cache.

large-binary-cache-miss-rate

The average number of misses on the large binary cache.

replication

This is a complex structure with the following children:

foreign-master

Foreign master for this database.

This is a complex structure with the following children:

relation

A specific related resource.

This is a complex structure with the following children:

qualifiers

A list of associated resources that distinguish the resource.

This is a complex structure with the following children:

qualifier

Another resource that qualifies the resource.

This is a complex structure with the following children:

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

roleref

A role that distinguishes the resource.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

relation-id

A resource related to the host.

foreign-database-id

A foreign database ID.

foreign-forest-id

A foreign forest ID.

foreign-replicas

Foreign replicas of this database.

This is a complex structure with the following children:

foreign-replica

Foreign replica of this database.

This is a complex structure with the following children:

relation

A specific related resource.

This is a complex structure with the following children:

qualifiers

A list of associated resources that distinguish the resource.

This is a complex structure with the following children:

qualifier

Another resource that qualifies the resource.

This is a complex structure with the following children:

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

uriref

The path for a resource or list of resources.

typeref

The type of a resource or list of resources.

roleref

A role that distinguishes the resource.

idref

The numeric identifier for the resource.

nameref

The name of the resource.

relation-id

A resource related to the host.

foreign-database-id

A foreign database ID.

foreign-forest-id

A foreign forest ID.

point-in-time-recovery

Information about point in time recovery.

This is a complex structure with the following children:

journal-archive

Information about the journal archive.

This is a complex structure with the following children:

path

The path of the stand.

lag-limit

The lag limit.

pending-frames

The number of pending frames.

pending-bytes

The number of bytes for pending frames.

pending-lag

The time of the pending lag limit.

unclosed-stands

The unclosed stands in the forest.

This is a complex structure with the following children:

unclosed-stand

The unclosed stand of a forest.

This is a complex structure with the following children:

stand-id

The unique key of a stand.

path

The path of the stand.

disk-size

The amount of space the stand takes on disk.

memory-size

The amount of space the stand takes in memory.

reference

The reference to an unclosed forest stand.

This is a complex structure with the following children:

count

The reference count.

earliest

The earliest refrence time.

latest

The latest refrence time.

frame

A stack frame.

forest-value-range

Value range of a range index

This is a complex structure with the following children:

cts:base-reference

cts:range

fragment-count

The total number of fragments for a given reindexing or rebalancing activity.

data-size

The amount of space forest data files take up on disk.

shared-disk-failover-active

retired

related-views

A list of broader or narrower views on the resource or resource type.

This is a complex structure with the following children:

related-view

A broader or narrower view on the resource or resource type.

This is a complex structure with the following children:

view-type

The kind of view.

view-name

The name of the view.

view-uri

The path for the view.

Example


http://localhost:8002/manage/v2/forests/my-forest-1?view=status

==> Returns status information on the forest named my-forest-1.
    

Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.